home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 26 / AMIGAplus Sonderheft 26 (2000)(Falke)(DE)(Track 1 of 2)[!].iso / Updates / AmigaOS3.5 / RAWBInfo / RAWBInfo.doc < prev    next >
Text File  |  1999-03-29  |  9KB  |  263 lines
  1.                  RAWBInfo
  2.         © 1999/2000 by Stephan Rupprecht
  3.             All rights reserved.
  4.  
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  RAWBInfo is copyrighted 1999-2000 by Stephan Rupprecht. 
  8.  All rights reserved. This program is freeware, so no financial
  9.  donations required. Redistribution allowed if the package is 
  10.  left unchanged. The author is not responsible for any damage 
  11.  caused by the use or misuse of this documentation and/or the 
  12.  program(s) it describes.
  13.  
  14.  
  15. REQUIREMENTS
  16.  Any Amiga® (compatible) computer with at least OS3.5 and
  17.  68020+ cpu.
  18.  gtdrag.library v3+ for drag'n'drop support from one RAWBInfo
  19.  window to another one (dev/gui/gtdrag#?.lha).
  20.  
  21.  
  22. DESCRIPTION
  23.  RAWBInfo is a replacement for the AmigaOS3.5 icon information.
  24.  Unlike the original one, this one uses ReAction for the user
  25.  interface.
  26.  
  27.  
  28. STARTING THE PROGRAM
  29.  The program can be started from shell as well as workbench. It
  30.  currently takes the following arguments:
  31.  
  32.  SDT=SHORTDATETIME/S,AC=ALLCONTROLS/S,WP=WINPOS/K,SBB=SIZEBBOTTOM/S,
  33.  DNI=DROPNEWICONSDATA/S,DP=DROPPLANARDATA/S,MV=MULTIVIEW/K,LOADPATH/K,
  34.  SAVEPATH/K,TOOLS/M,AGS=AUTOGETSIZE/S
  35.  
  36.  SDT=SHORTDATETIME/S: this option tells RAWBInfo to use the
  37.   short date and time format of the current locale. Enabling it
  38.   makes the icon information windows a bit smaller.
  39.  
  40.  AC=ALLCONTROLS/S: no function as of 1.8.
  41.  
  42.  WP=WINPOS/K: place where the window should be opened. Possible keywords
  43.   are (default is TOPLEFT):
  44.   TOPLEFT: open the window in the left corner right under the titlebar.
  45.   CENTER: center the window on the screen.
  46.   MOUSE: open it relative to the mouse pointer.
  47.  
  48.  SIZEBBOTTOM/S: makes the bottom border of information windows as high
  49.   as the sizing gadget.
  50.   
  51.  DNI=DROPNEWICONSDATA/S: when an icon was originally saved in NewIcons
  52.   format, setting this option keeps icon.library from saving the
  53.   information back to the .info file.
  54.  
  55.  DP=DROPPLANARDATA/S: setting this option will keep icon.library from
  56.   storing any pre OS3.5 image data.
  57.  
  58.  MV=MULTIVIEW/K: the path were multiview can be found. Default: Sys/
  59.   Utilities/Multiview.
  60.   
  61.  IE=ICONEDIT/K: the path of IconEdit, defaults to Sys:Tools/IconEdit.
  62.  
  63.  LOADPATH/K: initial path of the "Icon Image/Load ..." filerequester
  64.   (see later).
  65.  
  66.  SAVEPATH/K: initial path of the "Icon Image/Save ..." filerequester
  67.   (see later).
  68.   
  69.  TOOLS/M: a list of default tools that are available when you click
  70.   on the dropdown chooser (that's the button on the _right_ side of
  71.   the default tool string gadget).
  72.   Example: TOOLS="MultiView" "Installer"
  73.   
  74.  CREATEICON/K: For objects that don't have an icon, rawbinfo automatically
  75.   saves one to disk. If you don't want this to happen or only optionally,
  76.   you can set this option to either NEVER or ASK.
  77.   
  78.  AUTOGETSIZE/S: setting this option causes RAWBInfo to automatically
  79.   start calculating the drawer size.
  80.   
  81.  Once the program has been started it can be removed by either 
  82.  sending CTRL-C to it, by the system tool Exchange or by starting
  83.  it a second time.
  84.  
  85.  
  86. USAGE
  87.  Well, if you know how to use the original icon information, you'll
  88.  know how to use this replacement ;) So, I will just mention the
  89.  extras here:
  90.  
  91.  ° dropping an icon on the window will open another icon information
  92.    window with information on the dropped icon.
  93.    
  94.  ° if you drop an icon on the tooltypes gadget, the program will replace
  95.    the current tooltypes with the one the dropped icon has.
  96.  
  97.  ° the default tool of a project can also be changed by drag&drop.
  98.  
  99.  ° double-clicking the icon will open the workbench object.
  100.  
  101.  ° you can dragNdrop icons from one rawbinfo window to another one
  102.    (requires gtdrag.library by Axel Dörfler, dev/gui/gtdrag#?.lha).
  103.    
  104.  ° starting 1.7 the following menu functions are available:
  105.    
  106.    Project
  107.    ============
  108.    Next        activate and bring to front the next rawbinfo window.
  109.    Previous    same as above but the previous one.
  110.    ------------
  111.    Version...    get the version of the file (requires c:version!).
  112.    ------------
  113.    Save        save the icon to disk.
  114.    Load default Replaces the current icon with the default one.
  115.    icon   
  116.    Save as     allows you to save the icon as default one to disk.
  117.    default icon 
  118.    ...
  119.    ------------
  120.    Delete icon    delete icon.
  121.    ------------
  122.    About    program copyright and version.
  123.    ------------    
  124.    Quit        guess what it does ;)
  125.    
  126.    Type        the Type menu allows you to change the icon type.
  127.    ============
  128.    Disk
  129.    Drawer
  130.    Project
  131.    Tool
  132.    Garbage
  133.    
  134.    Icon Image
  135.    ============
  136.    Default    get default image (supports DefIcons).
  137.    Copy        copies current icon image to the clipboard.
  138.    Paste    replaces current icon image with the one
  139.            stored in the clipboard.
  140.    Restore    restore original icon image.
  141.    ------------
  142.    Convert to    allows you to convert any old style icon
  143.    palette     to an os3.5 color icon.
  144.    mapped
  145.    Extras/Remap swaps the colors of any *4 color* old style icon.
  146.    1.3/2.0    this is useful for converting os1.3 icon colors to
  147.            os2.0 colors.
  148.    ------------
  149.    Show clip ..    shows contents of the clipboad (see also
  150.            MULTIVIEW/K option).
  151.    IconEdit ... starts IconEdit.
  152.    ------------
  153.    Load ...    replace the current icon image with another one.
  154.    Save ...    allows you to save the current image to disk.
  155.    ------------
  156.    Frameless    make the icon frameless (works only for os3.5
  157.              coloricons, not for NewIcons!).
  158.    Drop     don't save NewIcons back in the NewIcons format.
  159.    NewIcons    
  160.    data
  161.    Drop planar    remove any old style image data from the icon.
  162.    data
  163.   
  164.    Tooltypes
  165.    ============
  166.    Clear    clear all tooltypes.
  167.    Sort        sort,
  168.    ------------
  169.    Disable all    disable,
  170.    Enable all    enable,
  171.    Toggle    toggle them ;)
  172.    ------------
  173.    Restore    restore original tooltypes.
  174.    
  175.  
  176. INSTALLATION
  177.  Simply use the supplied Installer script.
  178.  
  179.  
  180. SPECIAL THANKS GO TO
  181.  Thomas Richter for his help.
  182.  Nils Görs for the bug reports.
  183.  Roland Florac, Francis Labrie, Aleksandr, Alfredo Soro
  184.  Adam Chodorowski, Dámaso D. Estévez, Javier de las Rivas,
  185.  Llorenç Grau for the catalogs.
  186.  
  187.  
  188. HISTORY
  189.  1.0    first public release for os35 betatesters.
  190.  1.1    various changes. supports localisation now.
  191.  1.2    added AC=ALLCONTROLS/S and SDT=SHORTDATETIME/S options.
  192.      fixed Enforcer hit on exit (FreeClass() stub instead
  193.      of inline was used). Thanks to Nils Goers for the bug 
  194.      report.
  195.  1.3    More than 127 tooltypes weren't supported (crashed badly).
  196.      Fixed. Thanks again to Nils Goers :)
  197.  1.4    included french catalog by R.Florac (Roland, there's something
  198.      wrong with your email account, I wasn't able to reply to your
  199.      message). some internal changes I can't remember ;) Changed the
  200.      way the icon gadget reacts to mouse clicks, now it behaves
  201.      like workbench icons (well, almost;).
  202.  1.5    Calculation of drawersize can be aborted at any time now. fixed
  203.      small bug in icon duplication function.
  204.  1.6    added CENTERED/S,SIZEBBOTTOM/S,TOOLS/M options.
  205.  1.7    released to my homepage. added a couple of new functions, the majority 
  206.      of them were adapted from SwazInfo (Icon Image menu/Tooltypes menu ...).
  207.      Added drag'n'drop support via gtdrag.library. misc house-keeping
  208.      changes. included russian catalog by Aleksandr <nikolya@bios.iuf.net>,
  209.      new french one by Francis Labrie and a spanish catalog by
  210.      Alfredo Soro.
  211.  1.8    swedish catalog by Adam Chodorowski. changed the user interface
  212.      a bit (still has to be improved) and added some more "SwazInfo
  213.      functions". ALLCONTROLS/S option is obsolete now, the layout code tries
  214.      its best to make the gui fit on the screen.
  215.  1.9    just a minor update, I am currently too lazy to add the requested 
  216.      features ;) added stackswapping code. now disables the "Type" menu
  217.      when calculting the drawer size. added a requester when changing
  218.      the icon type. new options IE=ICONEDIT/K and CI=CREATEICON/K.
  219.  1.10    fixed bug in menu handling code, "Icon Image / Copy" crashed
  220.      when cgx pictdt was used <Javier de las Rivas>.
  221.  1.11    fixed an english text <G.Donner>. replaced CENTERED/S with WINPOS/K.
  222.      new menu item "Project / Load default icon". fixed Installer script.
  223.  1.11a    fixed another english text (loose->lose;). Thanks again to G.Donner.
  224.  1.12    the get size gadget could report the wrong size for very big drives
  225.      and drawers (>4gb) <Stephen White>. now disables "Project / Load
  226.      default icon" while retrieving the size of a drive or drawer. new
  227.      option AGS=AUTOGETSIZE/S. note to the translators: new rawbinfo.cd!
  228.  1.13    added a new menu item to the "Project" menu to get the version of
  229.      a file. removed the space between the last word of a menu item and
  230.      the ellipsis (...) <G.Donner>. for drawers >2gb and <4gb, a negative
  231.      size was shown because of a wrong formating code (note to the 
  232.      translators: MSG_DRAWER_SIZE_FMT_NEW has changed) <Klaus B. Küsche>.
  233.      new menu item "Image / Extras / Remap 1.3/2.0" to remap os1.3
  234.      icon colors to os2.0 colors and vice versa <Klaus B. Küsche>.
  235.  1.14    the size gadget updates in real time, now. replacing the icon image(s)
  236.      by drag'n'drop could fail when the source icon didn't have 2nd
  237.      image <Arturo Franzin>.
  238.  
  239.  
  240. TODO (in no special order)
  241.  - improve gui.
  242.  - arexx interface.
  243.  - implement rename function.
  244.  
  245.  
  246. AUTHOR
  247.  
  248.  Please send bug reports and ideas to:
  249.  
  250.     Stephan Rupprecht
  251.     Apfeldweg 1
  252.     D44359 Dortmund
  253.     Germany
  254.  
  255.  Send emails to
  256.  
  257.     stephan.rupprecht@gmx.de or
  258.     stephan.rupprecht@web.de
  259.     
  260.  WWW
  261.  
  262.      http://stephan.2xs.de
  263.